Release 10.1A: OpenEdge Development:
Progress 4GL Reference

ADD-LAST( ) method

Adds one or more items to the bottom of a combo box, radio set, or selection list.

Return type: LOGICAL

Applies to: COMBO-BOX widget, RADIO-SET widget, SELECTION-LIST widget

Combo-box and selection-list syntax

ADD-LAST ( { item-list | label , value } )

item-list

A character-string expression that represents one or more items, delimiter-separated.

label

A character-string expression that represents the label of a label-value pair.

value

The value Progress assigns to the field or variable if the user selects the corresponding label.

Note: If the widget’s entries consist of single items, use item-list. If the widget’s entries consist of label-value pairs, use label and value.

For combo boxes and selection lists, the delimiter is the value of the DELIMITER attribute, which is comma by default. Also, if the SORT attribute is TRUE, ADD-LAST sorts the new items by label before adding them to the widget.

Radio-set syntax

ADD-LAST ( label , value )

label

A character-string expression that represents the label of a label-value pair.

value

An INTEGER expression that represents the value of a label-value pair. When the radio set appears, if the user selects label, Progress assigns value to the corresponding field or variable.

For radio sets, if the AUTO-RESIZE attribute is TRUE; the size of the radio set changes. Otherwise, the radio set is clipped.

For all applicable widgets, if the operation is successful, ADD-LAST returns TRUE.

Note: If the widget’s entries consist of single items, each call to ADD-LAST can add multiple entries. If the widget’s entries consist of label-value pairs, each call to ADD-LAST can add one entry.

The following examples modify widgets whose entries consist of single items:

return-code = my-combo-box-hdl:ADD-LAST("Seoul").

return-code = my-sel-list-hdl:ADD-LAST("Bogota, Seoul, Los Angeles").

The following example modifies a combo-box widget of type INTEGER whose entries consist of label-value pairs:

return-code = my-widget-hdl:ADD-LAST("Bogota", 15).